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INTRODUCTION 

Cette carte a et§ congue pour I'APPLE® //e (equipe de 128Ko de memoire) et 
plus specialement pour I'APPLE Has. 

Le role essentiel de la carte DGA-1 est de numeriser un signal video et de le 
stocker dans sa propre memoire afin de pouvoir le traiter ulterieurement 
numeriquement et graphiquement. 



AVANTTOUTE UTILISATION DE CETTE 

CARTE, IL EST RECOMMANDE DE LIRE 

ATTENTTVEMENT CE MANUEL, AINSIQUE 

CEUX DE VOTRE MICRO - ORDBSfATEUR . 



La restitution des images se fait sur I'ecran de I'APPLE apres traitement par 
programme (des routines sont en memoire morte). 

La carte est livr§e avec un cordon permettant d'une part, de se connecter sur une 
source vid^o telle que camera ou magnetoscope, et d'autre part de raccorder un 
moniteur de controle restituant le signal d'entree, permettant de faciliter la mise au 
point dans le cas de I'utilisation d'une camera. 

Pour les possesseurs d'APPLE //e non equipes de carte graphique couleur telle 
les cartes EVE ou FELINE, 11 est possible de se procurer un cordon permettant de 
se connecter sur la prise PERITEL des televiseurs pour digitaiiser les images TV et 
de se servir de celui-ci comme moniteur (s'il supporte le standard PAL). 

Pour les possesseurs d'APPLE lie equipes de carte EVE ou FELINE, ou pour 
APPLE llGS, un boTtier special permet de realiser la meme fonction en restituant les 
images en couleur par les signaux RVB. Dans ce cas, le teieviseur pourra etre 
uniquement au standard SECAM. 



<^ APPLE est une marque d6pos6e d'APPLE Computer, Inc. 
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MISE EN PLACE 



Verifier avant toute manipiilation que votre 
micro-ordlnateur ne soft pas sous tension. 

Le montage ou le d^montage de la carte 

interface dans un APPLE sous tension 

pent entrainer des dommages graves 

an mat«el (APPLE et/ou carte). 

********** 



Installation 

-Verifiez que votre APPLE soit HORS TENSION et ouvrez le capot de celui-ci. 

-Fixez la prise 9 broches femelle du cable plat dans une des fenetres appropriees 
situees sur la face arriere de I'APPLE. Pour ce faire, il faut demonter les ecrous 
installes sur la prise, placer celle-ci sur la face interne du panneau arriere, puis 
remonter les ecrous k I'exterieur du panneau en les serrant fortement. Le cable 
de raccordement au signal video comporte, sur sa prise 9 broches male, des vis 
permettant de se reprendre sur ces ecrous pour une fixation efficace. 

-Raccordez I'autre extremite du cable plat au connecteur de la carte et montez 
celle-ci dans le slot choisi de I'APPLE. 



-Montez le cordon standard. Celui-ci est constitue d'une part, d'un cordon video 
LONG qui doit se raccorder par une rallonge sur la source video et d'autre part, 
d'un cordon vid^o COURT qui doit eventuellement se raccorder par 
I'intermediaire d'une rallonge a un moniteur de controle. 

-La carte est livree aprds controle et reglage en nos ateliers et doit done etre prete 
k fonctionner. Toutefois, suivant les sources, il peut etre necessaire de modifier 
les r^glages de luminosite et de contraste. Cette operation est decrite dans les 
chapitres suivants. 
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MONTAGE DE LA CARTE DANS L'APPLE 




Oers face auaiit 



BROCHAGE DU CONNECTEUR 



*1 2 Volts 



Comimutation 
PERITEL ■ 




Entrie vid6o 
Masse 
Sortie video 



Connecteur DB9 femelle 
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Chokduslot 

Que la carte soit implantee dans un APPLE //e ou dans un APPLE IIGS, elle peut se 
monter dans n'importe quel slot excepte le slot 3, celui-ci etant reserve a la gestion 
de I'ecran. Toutefois, si cette carte est utilisee sous PASCAL, elle devra etre 
montee en slot 1 . 

Configuration sur APPLE IlGS 

Dans le cas de Femploi de cette carte sur APPLE llGS, 11 ne faudra pas oublier de 
reconfigurer le slot choisi. Cette operation est effectuee dans le tableau de bord en 
selectionnant ['option "Connecteurs", puis en faisant apparaTtre I'option "Votre 
carte" en vis-a-vis du connecteur choisi pour la carte (voir Guide de I'utiiisateur). 

// faut sortir du programme "Tableau de bord" puis 6te'indre I'appareil pour que 
cette nouvelle configuration soit prise en compte par le systeme. 



Raccordements des equipements en sortie de f APPLE 

Raccordement sur camfra et raise an point sur moniteur de controle. 
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Raccordement sur APPLE // 6qiiip6 d'une carte couleur avec un televiseur 
domestiqiie. 



Ce type de raccordement necessite I'emploi d'un kit constitue d'un boTtier et d'un 
cable de raccordement au televiseur. Ce kit est disponible en option. 
Dans ce cas, la digitalisation est faite a partir du televiseur sur des emissions TV 
ou sur une retransmission de magnetoscope. Le televiseur sert egalement d'ecran 
couleur pour la visualisation de I'APPLE. 




RACCORDEMENT 
SUR CARTE DGA-1 



TELEVISEUR 
DOMESTIQUE 



CORDON CARTE 



COULEUR (EVE...) 




BOITIERDE 
CONNEXION TV 



PRISE PERITEL 



Raccordement sur APPLE IIgs avec un televiseur domestique. 

Le type de fonctionnement est identique a celui decrit ci-dessus. Le boTtier de 
connexion TV est alors relie a la prise 15 broches normalement utilisee pour la 
sortie video sur moniteur couleur. 
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INFORMATIONS TECHNIQUES 



Ci-dessous, le schema fonctionnei de la carte DGA-1 donne le synoptique des 
principaux elements. 
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Nous allons decrire en detail les differentes fonctionnalites de la carte et il est 
vivement conseille a I'utilisateur de lire attentivement ce chapitre pour prendre 
connaissance des reglages disponibles et bien saisir I'utilite de leur action. 
Une bonne connaissance du fonctionnement de la carte permettra d'employer 
celle-ci dans les meilleures conditions afin d'en obtenir des resultats optima. 

Signal d'entr^ 

La carte accepte un signal video standard. C'est une video composite 50Hz, 625 
lignes, d'amplitude IVcc. 

Ce type de signal est issu des cameras type surveillance noir & blanc, cameras 
couleurs de magnetoscope ou sortie video des magnetoscopes, signal video TV 
accessible sur la prise PERITEL des televiseurs domestiques... 

Dans tous les cas, la carte est congue pour restituer une image noir et blanc. Pour 

ce faire, elle analyse I'intensite du signal de la source, qu'il soit noir & blanc ou 

couleur. 

Toutefois, le signal d'une source couleur est constitue de deux informations 

(luminance et chrominance) qui seront prises en compte lors de la digitalisation. 

La chrominance constitue I'information couleur de la ligne et perturbe le signal 

digitalise. 

II est done conseille, dans le cas de source couleur, de mettre le switch repere 

FILTRE sur la carte en position ON afin de couper une partie de ce signal 

parasite. II se situe juste au-dessus du connecteur pour cable plat de sortie video. 

Dans le cas de digitalisation a partir de source noir & blanc, mettre le filtre sur OFF 

afin de ne pas perdre de la definition sur le signal. 

Signal de sortie 

Comme on le volt sur le schema fonctionnel, le signal d'entree attaque un 

amplificateur qui permet une mise a niveau correcte de celui-ci avant de rentrer 

sur le convertisseur video. 

Le gain de cet amplificateur est commande par le potentiometre repere LUM 

(lumiere) sur la carte. En manipulant celui-ci, on pourra done augmenter ou 

diminuer I'intensite du signal entrant sur le convertisseur et par la, avoir une image 

digitalisee plus ou moins sombre. 

La sortie de I'amplificateur commande egalement la sortie de la carte pouvant se 

raccorder sur un moniteur de controle. Le reglage de la lumiere se repercutera 

done sur le signal de sortie et sera visible sur le moniteur de controle. 

Pour que I'emploi du moniteur de controle soit significatif au point de vue du 

reglage de luminosite, il faudra apres quelques essais, regler celui-ci en 

concordance avec I'intensite de I'image digitalisee et visualisee sur le moniteur de 

I'APPLE. 
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K^ SYSTEMED'ANALYSE VIDEO 



Afin de mieux comprendre le fonctionnement de la carte, un court rappel des 

normes vid§o est n§cessaire. 

Un signal vid§o composite contient deux informations fondamentales : 

- Les signaux de synchronisation lignes et frames. 

- L'information video permettant de restituer I'image. 



■0,7V--i- 




Synchro 
horizontale 




Information 
yideo analogique 



Palter avant — N 



^ '^Palier am" ere 



Signal video composite 

Bappel sur les lignes et les frames 

Chaque image est exploree selon des lignes horizontales et de haut en bas. 
Chaque ligne analyse point par point I'image de gauche a droite. 

L'analyse debute au coin superieur gauche, elle parcourt I'image jusqu'a 
I'extremite droite pour former une premiere ligne legerement descendante. 

Le spot lumineux sur I'ecran du recepteur s'eteint et il revient tres rapidement a 
I'extremite gauche pour tracer la deuxieme ligne legerement en-dessous de la 
premiere. II parcourt ainsi toutes les lignes jusqu'a la derniere qui se termine en 
bas a droite de I'ecran. Chaque depart de ligne est identifie par la syncfiro ligne. 

A ce moment, un signal de synchronisation different et plus long que celui des 
lignes, §teint le spot et le ramene rapidement en haut et a gauche de I'ecran pour 
tracer la premiere ligne de la seconde image. II s'agit de la synctiro frame. Ce type 
de balayage de I'image est dit simple. 
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En video, la frequence des images est de 25 par seconde (ou 30 par seconde 
dans certains pays) avec un balayage entrelace. 

Dans un systdme a balayage entrelace, on affiche tout d'abord les lignes de rang 
impair puis les lignes de rang pair. 

Chaque demi-image s'appelle une trame. Avec 25 images par seconde, on obtient 
done 50 trames par seconde. 

Les lignes des deux trames successives doivent etre legerement decalees, afin de 
ne pas etre superposees, et le nombre de lignes doit etre impair (la definition en 
television est de 625 lignes). 



Ligne 1 ere trame 



Ligne 2eme Irame 




Affichage d'une image en mode entrelace 



Les lignes sont en traits pleins, les retours de lignes en pointilles et les retours de 
trames en tirets. 
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KW DETECTEURDE SYNCHROS 



Le signal video rentrant sur I'amplificateur attaque egalement un circuit specialise 
(TDA2595) qui permet de detecter les tops de synchronisation et de les separer du 
signal vid§o. 

Ce circuit possede un potentiometre d'etalonnage PI qui doit etre regie pour 
assurer son bon fonctionnement. C'est un potentiometre plat qui se situe sur le bas 
de la carte et qui est done volontairement impiante d'une maniere peu accessible. 

Son regiage est effectue lorsque la carte vous est livree et 11 n'est pas necessaire 

(et meme fortement deconseille) d'y retoucher. 

Toutefois, nous vous donnons la methode d'etalonnage de ce circuit en cas de 

dereglage intempestif pour une raison quelconque. 

II est necessaire de posseder un oscilloscope pour proceder k ce regiage. 

- Connectez I'oscilloscope sur la broche 9 du TDA 2595. 

- Connectez une source video sure a I'entree de la carte (camera par exemple). 

- Mettez votre APPLE sous tension. 

- Manipulez le potentiometre jusqu'a visualiser les signaux de synchronisation 
lignes et trames sur I'oscilloscope. (Amplitude 12V) 

- Reglez le potentiometre au centre de la plage ou ces signaux sont visibles. 
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KW FONCTIONNEMENTDE LA CARTE 

La carte fonctionne dans un seul mode de digitalisation. La restitution de I'image 
sous diff§rents formats en fonction de I'unite centrale sera traitee par programme. 

Lorsqu'un ordre de digitalisation est passe a !a carte, !a logique de commande 

attend tout d'abord un signal de synchronisation frame afin de commencer son 

analyse dans un ordre logique. Elle fera alors la digitalisation d'une trame, soit 

une demi-image. 

Comme nous I'avons vu precedemment, le signal de synchronisation trame arrive 

a chaque demi-image. Pour etre sur, lors de digitalisations successives, de 

prendre en compte toujours Jes memes lignes sur un signal en balayage 

entreiace, un systeme permet de se recaler toujours sur la meme trame. 

La duree d'une digitalisation pourra done etre de 60 ms dans un cas extreme, 

c'est-a-dire, 40 ms d'attente de la bonne trame plus 20 ms de digitalisation de la 

trame desiree. 



Digitalisation sur 200 lignes. 

La carte est constmite pour digitaliser sur 200 lignes consecutives. 
Le signal video visible sur une trame est de 289 lignes. Pour repartir la position de 
I'image digitalisee en fonction des 89 lignes perdues, la logique de commande 
attend 40 lignes avant de debuter la digitalisation. 

DigitaEsation sur 320 points par ligne. 

La carte digitalise toujours 320 points par ligne. Le signal de synchro ligne est 

detecte et apres un retard necessaire pour tenir compte du temps de palier arriere, 

la digitalisation d'une ligne est iancee. Chaque point echantillonne est stocke 

dans la memoire d'image de la carte. Un compteur de points permet de stopper la 

digitalisation ligne au bout de 320 points. 

Le potentiometre repere FP sur la carte permet d'ajuster cette frequence 

d'echantillonnage. II est regie en nos locaux au test de la carte et ne devrait pas 

etre retouche. 

La maniere la plus simple pour proceder a son reajustage est de lancer des 

digitalisations continues et d'afficher le resuitat sur I'ecran de I'unite centrale, 

I'image originale etant visualisee sur le moniteur de controle. 

II suffit alors de comparer le bord droit de chaque image pour se rendre compte du 

bon reglage. 

Attention : si la frequence d'echantillonnage devient trop faible, le systeme n'a pas 
le temps de compter ces 320 points pendant la duree d'une ligne et toute la 
logique de la carte est desynchronisee. 
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KW STOCKAGEDESVALEURS 

L'horloge, cadengant le rythme d'echantillonnage des points, pilote egalement le 

convertisseur video qui effectue une conversion analogique-numerique sur 4 bits, 

permettant d'affecter 16 valeurs possibles pour le point analyse. La valeur binaire 

est alors stockee dans la memoire image de la carte. 

Pratiquement, deux points sont memorises dans un registre tampon avant d'etre 

stockes en memoire du fait que celle-ci travaiile sur 8 bits de donn6es. 

Le stockage dans la memoire se fait de maniere continue vis-a-vis de son 

adressage. Les deux premiers points sont stockes a I'adresse et les deux 

derniers a I'adresse 31999 ce qui donne un total de 64000 points. 

Note : Les valeurs donnees precedemment sont indiquees pour une meilleure 
comprehension du fonctionnement et en particulier vis-a-vis de la lecture des 
donnees pour affichage, les 200 lignes representant le maximum de resolution de 
I'unite centrale lorsque la carte est implantee sur un APPLE IIGS. 
Toutefois, la memoire d'image ayant une capacite de 32768 octets, la digitalisation 
se fait pratiquement sur la capacite totale de la memoire soit sur 204,8 lignes. 
Cette rectification est donnee pour les utilisateurs plus interesses par le traitement 
des valeurs que par la representation graphique a I'ecran. 



Ceci clot la description de la partie digitalisation automatique de la carte. Nous 
aliens voir maintenant comment acceder aux commandes et a la lecture des 
donnees vis-^-vis de I'unite centrale. 
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ABRESSAGE BE LA CARTE 

Sur la carte est implantee une memoire programme dont I'acces par des 
commandes specifiques permet de mettre en cEuvre des routines specialisees 
facilitant le traitement des donnees, en particulier pour I'affichage. 
Toutefois, I'objet de ce chapitre est de decrire la maniere de commander la carte 
directement pour pouvoir eventuellement creer ses propres routines de traitement. 
L'acces a la memoire programme sera uniquement decrit afin que le developpeur 
qui le desire puisse creer en ROM ses propres routines. 

Les informations donnees ci-apres etant tres proches du cceur de la machine, une 
connaissance du microprocesseur de I'unite centrale (6502 ou 65816) est 
souhaitable. Les exemples d'adressage seront donnes en code hexadecimal pour 
etre plus proche des programmes qui pourraient etre ecrits en langage machine. 
La transcription des exemples en langage de plus haut niveau comme le BASIC 
etant plus evidente dans ce sens qu'a I'inverse. 



CONVERSION BMAIRE-DECIMALE 

La description technique de certaines adresses sera faite au niveau de chaque bit 
des octets de commande ou d'etat. I! est bon de rappeler quelques definitions a ce 
sujet. 

Les donnees sont definies par des mots de 8 bits representant un OCTET. La 
combinaison de ces 8 bits, notes de a 7, represente une valeur binaire de $0 a 
$FF en notation hexadecimale. Rappelons qu'en base 16, les valeurs superieures 
a 9 sont notees de A a F. 

Le poids binaire de chaque bit a 1 est represente dans le tableau ci-dessous. 
Conventionnellement, le bit de poids le plus faible est represente a droite et le bit 
de poids le plus fort a gauche. 



7 6 5 4 3 2 1 I N° du bit 
128 64 32 16 8 4 2 1 I Poids binaire 



Pour convertir une valeur notee en binaire en valeur decimate, 11 suffira 
d'additionner le poids binaire de chaque bit a 1. La valeur d'un octet en decimal 
pourra done etre comprise entre et 255. 
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Zone d'adressage de la memoire programme 

Sur I'APPLE, une zone d'adressage de 256 octets est reservee pour chaque slot a 
du programme ecrit en langage machine. Ces adresses se trouvent dans la zone 
$Cn00 a $CiiFF, ou n represente le numero du slot oij est implantee la carte. 

Exemple pour le slot 2 : $C200 k $C2FF 

De plus, une zone d'adressage de $C800 a $CFFF est commune a tous les slots 
et egalement reservee a I'utilisation des programmes des cartes interfaces. 

La memoire programme de la carte DGA-1 , de type 2764 a une capacite egale a 4 
fois celle de I'espace prevu. Elle sera done divisee en quatre bancs identiques vus 
de ['unite centrale et on accedera a chacun de ces bancs en positionnant des 
commutateurs logiques dont les adresses sont situees dans I'espace des entrees/ 
sorties (Voir paragraphe suivant). 



Ecriture d'un programnie en memoire 

a) Le debut du programme sera toujours dans la zone $Cn00 a $CnFF. Le fait de 
travailler dans cette zone memoire autorisera automatiquement l'acces a la zone 
$C800 de la carte. 

b) Pratiquement, cette zone est recopiee dans les quatre bancs de la memoire afin 
qu'un acces soit toujours correct, quel que soit I'etat des commutateurs logiques. 
C'est dans cette zone qu'il faudra effectuer la commutation sur le banc desire 
avant de passer a la partie du programme ecrit dans la zone $C800. 

c) Dans cette zone, il ne faudra pas oublier de prendre la precaution de faire appel 
a I'adresse $CFFF. Cette adresse, par convention, permet de deselectionner la 
zone $C800 de toutes les autres cartes interfaces qui pourraient etre actives a ce 
moment (rappelons que cette zone est commune a toutes les cartes). 



Note : Lorsque Ton programme une telle memoire, la zone $C800 se situe au 
depart de I'adressage logique de la memoire et la zone $Cn00 aux adresses qui 
seraient occupees par la zone $CF00 a $CFFF. 



Carte DGA-1 



Nautil 



Page 16 



Adressage des entrees/sorties 

En plus de la zone memoire reservee pour les programmes, une zone 
d'adressage de 16 octets est reservee a chaque slot pour commander les entrees- 
sorties des cartes. 

Ces adresses se situent dans I'espace $C0(n+8)0 a $C0(n+8)F, b representant 
le numero du slot. 

Exemple pour le slot 2 : $C0A0 k $C0AF 

Sur la carte DGA-1 , seules les 8 premieres adresses sont utilisees. Toutefois, le 
mode d'acces (lecture ou ecriture) est important a respecter pour un resultat 
correct. Gertaines adresses permettent des fonctions differentes suivant le mode 
d'acces alors que d'autres ne fonctionnent que dans un seul des deux modes. 

Ce sont les fonctions relatives a ces adresses que nous aliens decrire maintenant. 

^ AVERTISSEMENT 

Toutes les adresses seront donnees sous reference du systeme de base 

APPLE. 

Le systeme CP/M genere des translations d'adresses. Ainsi, les zones 

d'adresses relatives aux slots sont decalees de $2000 et se trouvent done 

dans I'espace $E000 a $EFFF. 



ItP^ SELECTION DES BANCS DE LA MEMOIRE PROGRAMME 



Quatre adresses consecutives permettent de selectiomier respectivement les 
bancs a 3 de la memoire programme : $C0(n+8)4 a $C0(ii-i-8)7. II faudra y faire 
reference en mode ecriture pour programmer le banc choisi. Toutefois, le contenu 
des donnees a ecrire est sans importance et est ignore. 

Exemples pour le slot 2 : 



Assembleur 
•BASIC 

MBASIC 



STA $C0A4 ; Valeur de A indifferente 

POKE 49316,0 
POKE 57508,0 
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K^ COMMANDS DE DIGITALISATION 



Cette commande permet de declencher une digitalisation. Elie se fait a I'adresse 
$C0(n-i-8)l en mode ecriture. Toutefois, le contenu des donnees est sans 
importance et est ignore. 



Exemples pour le slot 2 : 



Assembleur 

BASIC 
MBASIC 



STA $C0A1 
POKE 49313,0 
POKE 57505,0 



; Valeur de A indifferente 



Si une source vid^o est connectee a la carte, la digitalisation sera terminee un 

maximum de 60 ms aprds cette commande. 

Si aucune source n'est connectee, la digitalisation n'aura pas lieu et la carte 

restera en attente des signaux de synchronisation frame. 

Voir la description du registre d'etat pour connaTtre la phase de digitalisation. 
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K^ COMMUTATION PERITEL 

Cette fonction permet de commander la sortie de la carte qui attaque la 

commutation d'une prise PERITEL lorsqu'un televiseur sert k !a fois de source 

video et d'ecran pour I'unite centrale. Ceci implique I'utilisation du bottler 

auxiliaire. 

Elle fait appel & deux adresses en mode ecriture qui sont $C0(ii+8)2 et 

$C0(ii+8)3. Le contenu des donnees est sans importance et est ignore. 

Exemples pour le slot 2 : 

- Passage en mode televiseur (le televiseur sert uniquement de source video a la 
carte) 



Assembleur 

BASIC 
MBASIC 



STA $C0A2 
POKE 49314,0 
POKE 57506,0 



; Valeur de A indifferente 



- Passage en mode moniteur (le televiseur sert a la fois d'ecran pour I'APPLE et de 
source video a la carte) 



Assembleur 

BASIC 
MBASIC 



STA $C0A3 
POKE 49315,0 
POKE 57507,0 



; Valeur de A indifferente 



Cette derniere commande est le mode par defaut de la carte. 



Pratiquement, ces commandes agissent sur la broche 5 de la prise DB9 de sortie. 
La commande a I'adresse $C0(n+8)2 positionne cette broche au niveau +12 Volts 
et la commande a I'adresse $C0(n+8)3 positionne la broche au niveau Volt. 
Une remise en forme de ce signal est faite dans la prise PERITEL du cordon fourni 
pour commander correctement les broches 8 (commutation lente) et 16 
(commutation rapide). 
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Hy REGISTRED'ACCES 

Ce registre permet la selection d'acces a la memoire programme ou a la memoire 
image, ainsi que la selection des differentes zones de cette derniere. La 
programmation de ce registre se fait, bien evidemment en mode ecriture, a 
I'adresse $C0(n+8)0. Les donnees doivent contenir la valeur desiree illustree 
par le croquis ci-dessous. 





D7 1 - 1 - 1 D4 1 D3 1 D2 1 D1 1 DO 






t 


i i 


i i 


. .r-y 












1 


selection des 
32 bancs de la 
mimoire image 


Selection mSmoires 












= memoire programme 












1 = memoire image 







Exemples pour le slot 2 



Assembleur: 



BASIC 



LDA 
STA 
POKE 



#$81 

$C0A0 
49312,129 



; Selection du banc 1 memoire image 
; Programme le banc 



MBASIC : POKE 57504,129 

Acces & la mimoire image 

On accede a la memoire d'image egalement par les adresses de la zone $C800. 

Le bit 7 du registre d'acces permet de determiner dans quelle memoire se fera 

I'acces de cette zone. 

La memoire d'image est decoupee, vue du systeme, en 32 bancs de 1024 octets 

dont I'acces se fait dans la plage $C800 a $CBFF. Chaque banc etant positionne 

de a 31 par les 5 bits bas du registre d'acces. 

D'une maniere pratique, pour ecrire un programme de gestion en ROM sur la 

carte, il faudra se situer dans la zone $Cn00 pour acceder a la RAM. 

II faudra, dans cette zone, positionner le bit 7 du registre d'acces a 1 ainsi que le 

numero du banc, faire I'operation de lecture ou d'ecriture dans la memoire image 

et enfin, remettre le bit 7 du registre d'acces a afin de pouvoir continuer le 

programme dans la zone $C800 de la memoire programme. 
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IC^ REGISTRE D'ETAT 

Le registre d'etat possede uniquement quatre bits significatifs. Les autres bits sont 
indetermines et peuvent prendre des valeurs quelconques. Leur fonction est 
illustree dans le croquis ci-dessous. 



Commaode digitalisation 



= Digitalisation commandie 

1 = Prit pour conversion 



T 



D7 D6 - - 



.1- 



Etat digitalisation 



= Digitalisation en cours 

1 = Digitalisation terminee 



a 



Memoire sSlectionnee 



= memoire programme 

1 = memoire image 



Y 



i - I - i - I D1 I DO 



Commande PERITEL 



= Mode moniteur 

1 = Mode source TV 



-► BIT 1 

Ce bit est le reflet de I'etat programme par les adresses $C0(n+8)2 et $C0(n+8)3 
permettant de piloter les televiseurs domestiques. En testant ce bit, un programme 
peut done connaTtre I'etat de cette commande et agir en consequence pour 
digitaliser ou afficfier un resultat. 

^ BIT 6 



Ce bit est identique a celui programme dans le bit 7 du registre d'acces. II peut 
done servir de controle, dans un programme, pour connaTtre I'autorisation d'acces 
aux zones $C800 de la memoire programme ou de la memoire d'image. 
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■4 BIT 7 

Ce bit est positionne a 1 pour indiquer qu'une commande de digitalisation est 
possible. C'est son etat au repos. 

II passe a des qu'une commande de digitalisation est programmee par I'adresse 
$C0(n+8)1 . 

-♦■ BIT 

Ce bit normalement a 1 passe a pour indiquer qu'une digitalisation est en cours, 
c'est-a-dire que la bonne synchro trame a ete detectee et que le stockage des 
points en memoire est en cours. II reste done dans cet etat pendant 20 ms. 
Lorsque la digitalisation est terminee, ce bit repasse a 1 ainsi que le bit 7. 
C'est done la combinaison des bits 7 et qui permet de connaTtre I'etat du cycle 
de digitalisation. Les differents etats d'un cycle sont resumes dans le tableau 
ci-dessous : 



BIT 7 


BIT 


ETAT 


1 




1 


1 

1 


1 


Etat repos, pret pour digitalisation. 
Digitalisation programmee, 
attente de la synchro trame. 
Stockage des points en cours. 
Fin de digitalisation. 


1 





Etat impossible. 



Le test de ces deux bits permettra de connaTtre d'une part la fin d'une digitalisation 
avant d'entamer le programme de gestion des resultats, et d'autre part de 
s'assurer de la bonne connexion de la source video par une boucle de 
temporisation superieure a 60 ms. 
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UTILISATION SOUS BASIC APPLESOFT 

Nous allons decrire ci-apres les commandes de la carte permettant de faire appel 
aux routines ecrites dans la memoire programme. 

Toutes les commandes sont constituees par une sequence de caract^res dont le 
premier est un caractere de controle de commande, suivi par une ou plusieurs 
lettres (toujours passees en MAJUSCULES) pouvant etre separees par des 
espaces. La fin de la sequence etant signalee par le caractere de fin de ligne 
(Retour chariot ou Return). 

Le caractere de controle de commande est fix§ par defaut comme etant un (Ctl-I) 
pour rester dans la norme des cartes interfaces courantes, mais 11 peut etre 
modifie. 

Utilisation en mode direct 

Le caractere de controle (Ctl-I) s'obtient en appuyant sur la touche Ctrl, puis sur 
la touche I en maintenant la premiere appuyee et enfin en relachant les deux 
touches simultanement. 

Toutes les commandes tapees en mode direct, bien qu'etant prises en compte par 
la carte, generent le message SYNTAX ERROR a I'ecran lorsque Ton termine la 
ligne par la touche Retour chariot. Ceci est normal car ces commandes ne sont 
pas comprises par le BASIC. 

Exemple pour une carte en slot 2 



PR£2 (Return) 
(Ctl-I) AV (Return) 
PR£0 (Return) 
TEXT (Return) 



Selectionne la carte en slot 2 
Digitalise (A) et visualise (0V) 
Revient sous BASIC 
Repasse sur I'ecran texte 



<B> Remarqne : Si Ton travaiUe avec un clavier americain, le caractere £ 
devra etre remplace par le caractere # 
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Utilisation en mode PROGRAMME SANS DOS 

En mode programme, le caractere de controle de commande (Ctl-I) se notera par 
I'instruction BASIC CHR$(9) afin de faciliter la lecture des programmes. 
Le meme exemple que precedemment s'ecrira de la maniere suivante : 

10PR£1 

20 PRINT CHR$(9);"AV" 

30PR£0 

Taper ensuite en mode direct la commande : RUN pour faire afficher le resultat de 
la digitalisation. 

Utilisation en mode PROGRAMME AVEC DOS 



Si Ton travaille sous DOS (Disk Operating System), c'est-a-dire apres avoir 
demarre I'APPLE avec une disquette (DOS 3.3 ou PRODOS), il sera necessaire 
de passer le caractere de controle du DOS (Ctl-D). 

Le programme exemple pourra alors s'ecrire de la maniere suivante : 

10 D$ = CHR$(4) : 1$ = CHR$(9) : REM Cfl-D et Ctl-I 
20 PRINT D$;"PR£2" 
30 PRINT I$;"AV" 
40 PRINT D$;"PR£0" 

Comme precedemment, taper en direct la commande : RUN pour lancer ce 
programme. 

Note : Pour envoyer un retour chariot en fin de ligne sous mode programme, il 
suffit que I'ecriture de la ligne soit faite comme les exemples precedents. Seul un 
point-virgule en fin de ligne supprime renvoi du caractere terminateur. 
Rappelons qu'un retour chariot doit toujours avoir ete envoye avant de passer une 
commande DOS debutant par un (Ctl-D). 
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Modification du caractere de controle de commande. 

Pour modifier ce caractere, il suffit d'envoyer le caractere de controle en cours, 
suivi immediatement par le nouveau caractere de controle souhaite et terminer la 
sequence par le retour chariot. 

Par example, la sequence suivante change le (Ctl-I) en (Ctl-Q) 
En mode direct : 



(Ctl-I) (Ctl-Q) 
PRf0 

En mode programme : 

10 PRMT CHR$(4);"PR£2" 
20 PRINT CHR$(9);CHR$(17) 
30 PRINT CHR$(4);"PRf 0" 

II faut en plus que cette sequence soit envoyee en debut de ligne pour etre prise 
en compte. 

Note sur les sequences de programmation 

II existe deux types de sequences de programmation qui peuvent etre envoyees a 
la carte. 

1) Les commandes de fonction proprement dites qui ont un resultat immediat 
(digitalisation, affichage...) 

2) Les commandes qui modifient des parametres (changement de caractere de 
controle, modification de palettes...) 

Ces demieres restent memorisees tant que I' APPLE n'a pas ete mis hors tension. 
II n'est done pas necessaire de les reprogrammer a chaque fois que Ton fait appel 
a la carte. 
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IC^ NOTES SUR L'OCCUPATION MEMOIRE 



Les routines de la carte effectuant des affichages dans des zones pouvant etre 
occupees par du programme BASIC, il est necessaire de rappeler les precautions 
a prendre au sujet de I'occupation memoire des programmes BASIC qui 
cohabitent avec des affichages en haute resolution. 

En DOS 3.3, un programme BASIC s'implante a I'adresse 2048 ($800) de la 

memoire principale et occupe les adresses suivantes dans un ordre croissant. Une 

image affichee en double haute resolution par la carte s'implantera a partir de 

I'adresse 8192 ($2000) et occupera un espace de 8192 octets dans la memoire 

principale (autant dans la memoire auxiliaire aux memes adresses), se terminant 

done k I'adresse 1 6384 ($4000). 

Une des premieres consequences est done que le programme BASIC n'empiete 

pas sur ces adresses car cette partie serait detruite par I'affichage. II devra done 

avoir une taille maximum de 6144 octets. 

De plus, il faudra prendre garde a ['implantation des variables utilisees par ce 

programme. 

Sans precaution particuliere, les variables numeriques s'implantent a la suite du 

programme en occupant un emplacement constant, fonction du nombre de ces 

variables. 

Les variables alphanumeriques s'implantent en haut de memoire et occupent un 

nouvel emplacement en decrementant les adresses a chaque fois qu'on les 

modifie. II y a done la un double risque de voir ces variables detruites par- 

I'affichage d'une image. 

II y a deux fagons de remedier a ce probleme : 

1) Le programme BASIC est relativement court et il reste de la place sous la page 
haute resolution pour stocker les variables. 

Dans ce cas, I'instruction HIMEM : 8192 force I'implantation de toutes les 
variables sous la page graphique. 

2) Le programme BASIC est relativement long (il ne faut toutefois pas qu'il 
d§passe 6100 octets). 

Dans ce cas, I'instruction LOMEM : 16384 force I'implantation de toutes les 
variables au-dessus de la page graphique. 
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Les valeurs donnees precedemment ne concement que I'affichage. Les routines 
de transfert pour sauvegarde occupent un espace plus important. 
Ci-dessous, nous donnons les valeurs typiques pour les diff§rents types 
d'utilisation. 

- Programme concerne uniquement par I'affichage. 

HIMEM:8192 ($2000) ou LOMEM:16384 (4000) 

- Programme faisant uniquement des transferts d'images en mode APPLE //e. 

HIMEM:8192 ($2000) ou LOMEM:24576 ($6000) 

- Programme faisant des transferts de memoire image, ou d'images en mode 
APPLE llGS. 

HIMEM:4096 ($1000) ou LOMEM:36864 ($9000) 



Note : Les valeurs donnees ci-dessus concernent principalement les applications 

ecrites sous DOS 3.3. 

Dans le cas d'applications ecrites sous PRODOS, seul le premier exempie teste 

valable. , ^. . 

En effet dans le cas de transfert de fichier, et principalement pour les routines de 
chargerrient, la commande HIMEM a une valeur inferieure k I'adresse de 
chargement aurait pour consequence de generer un message 'NO BUFFER 
AVAILABLE". , ^ , 

En consequence de quoi, seules les instructions LOMEM aux valeurs §nonc6es 
ci-dessus devront etre employees sous PRODOS. 
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UTTLISATION SOUS CP/M 



Limites d'utilisation 



L'emploi de la carte DGA-1 sous CP/M devra se limiter k une exploitation sous 
BASIC (ou eventuellement avec un programme specifique ecrit en Assembleur). 
II est hors de question d'employer cette carte directement sous systeme. 
Les ordres seront passes a la carte par I'instruction BASIC : LPRMT. 

Implantation 

Sous CP/M, les slots de I'APPLE ont des exploitations bien precises. La carte 
DGA-1 est reconnue par le systeme comme une carte imprimante. Elle devra done 
etre montee en slot 1 dans la mesure du possible. Toutefois, comme ce slot est 
reserve aux cartes imprimantes, il est possible de I'implanter dans n'importe quel 
autre slot (excepte le slot 3) grace a certaines modifications du systeme. 

Ci-dessous, la routine permettant d'utiliser la commande LPRINT du GBASIC pour 
des cartes montees dans un slot quelconque. 

Dans cet exempie d'application generate, la chatne A$ contiendra, dans notre cas, 
le caractere de controle de commande suivi de la commande proprement dite. 
Dans la description des commandes, un exempie sous GBASIC sera donne pour 
chaque commande. 

10000 N=2:REMNestlenumero(iuslot 

10010 POKEA1J4 

10020 POKEA2^ 

10030 POKEA3,Y 

10040 LPRINT A$; 

10050 P0KEA1,1: 



REM Envoi de la chaine A$ 

REM Eventuellement retour en slot 1 



Par exempie, pour reprendre I'exemple donne sous BASIC APPLESOFT, la 
digitalisation suivie d'une visualisation sera notee ainsi : 

A$ = CHR$(137)+"AV" 

Cette ligne amene une remarque : le caractere de controle (Ctl-I) est utilise sous 
GBASIC pour les tabulations. Pour qu'il soit reconnu par la carte, il faut I'envoyer 
en lui ajoutant 128 (9+128=137). 

Si Ton souhaite proceder d'une autre fagon, on peut, en debut d'application, 
changer la valeur du caractere de controle de commande, par exempie par un 
(Ctl-Q), par la commande : 

LPRINT CHR$(137);CHR$(17) 
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Le tableau ci-dessous donne les valeurs des parametres documentes dans le 
programme d'exemple precedent. 

Note ■ Les valeurs pour un CP/M 48K sont donnees seulement a litre indicatif car, 
Sirnme sous BaIiC APPLESOFT, Temploi de cette carte necessite une carte 
extension memoire pour avoir 128Ko dans le systeme. 





Version C 
48K 


P/M 2.20 

64K 


Version CP/M 2.23 
48K 64K 


A1 
A2 
A3 
X 

Y 


&HAD2C 

&HAD2F 

&HAD30 

&H04 

&HAD 


&HDD2C 

&HDD2F 

&HDD30 

&H04 

&HDD 


&HFE4D 

&HFE50 

&HFE51 

&HA9 

&HFD 


&HFE56 

&HFE59 

&HFE5A 

&HA9 

&hFD 



Version CP/M 2.26 

Pour utiliser cette methods avec la version CP/M 2.26 (fournie avec la carte 
PREMIUM), il suffit de passer une seule commande : 



POKE &HFB85J^ 
ou N est le numero du slot. 
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UTILISATION SOUS PASCAL UCSD 

Comme sous CP/M, les slots de I'APPLE ont des regies d'utilisation precises sous 

PASCAL UCSD. 

La carte etant reconnue comme une carte imprimante, elie ne pourra etre montee 

qu'en slot 1 sous ce systeme. 

De plus, elle ne pourra etre utiiisee qu'en mode programme. 

Programme d'litlllsatioii 

Pour commander !a carte a partir d'un programme, 11 faudra lui affecter un fichier 

texte que nous nommerons PTR dans les exempies suivants. 

Les commandes seront alors passees comme des commandes d'impression. 

L'exemple ci-dessous permettra, comme illustre sous BASIC APPLESOFT ou 
GBASIC, de passer une commande de digitalisation suivie d'un affichage a 
I'^cran. 

(*$S+*) 

PROGRAM AFFICHE; 

USES TURTLEGRAPHICS; 
VAR PTR:TEXT; 

BEGIN 

BOTTURTLE; 

TEXMODE; 

REWRITE ff*TR,'PRINTER:'); 

WRTTELN (PTR,CHR(9),'AV'); 

CLOSE (PTR); 
END. 



II sera necessaire d'utilisiser TURTLEGRAPHICS et de faire une initialisation par 
I'instruction INITTURTLE pour reserver la place memoire necessaire a I'affichage. 

Dans la description des commandes, un exemple sera donne sous PASCAL ne 
reprenant que la ligne de commande proprement dite. 
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COMMANDES DE LA CARTE 



(Ctl-I)D ) Parametres par defaut 



BASIC 

GBASIC 

PASCAL 



PRINT CHR$(9);"D" 
LPRINT CHM$(137);"D" 
WRTTELN (PTR,CHR(9),'D'); 



Les parametres concemes sont les suivants : 

- Le caractere de controle de commande est le (Ctl-I). 

- Passage en mode texte. 

- Affichage en mode noir & blanc. 

- Commutateur PERITEL en mode moniteur. 

Ceci correspond egalement a I'etat de la carte a !a premiere mise sous tension de 
I'APPLE. 

Remarque : Cette commande ne supporte pas le chaTnage d'autres commandes a 
sa suite. Elle doit etre terminee par un Return. 



(ci-l)A) Commande de digitalisation 



BASIC :PR1NTCHR$(9);"A" 
GBASIC : LPRINT CHR$(137);" A" 
PASCAL : WRTTELN (PTR,CHR(9),'A'); 

Cette commande permet de lancer uniquement une digitalisation, c'est-a-dire que 
la conversion s'effectue uniquement au niveau de la carte par le stockage des 
points dans la memoire d'image de celle-ci, sans entramer de modification au 
niveau de I'ecran de I'unite centrale. 

Pour gagner du temps au niveau des programmes, il n'y a aucun controle de 
signal video sur cette commande. L'ordre de digitalisation est uniquement passe 
au systeme de conversion de la carte. La vaiidite de la digitalisation sera controiee 
sur les ordres de visualisation. 
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(Ctl-l)nM) yode de visualisation 



BASIC 

GBASIC 

PASCAL 



PRINT CHR$(9);"0M" 
LPRINT CHR$(B7);"1M" 
WRTTELN (Pm,CHR(9),'2M'); 



Cette commande permet de programmer le mode d'affichage de I'image 

digitalisee qui sera visualisee par la commande (Ctl-i)V sur I'ecran de I'unite 

centrale. 

Sa vaieur par defaut sera n = 0. 

Dans le cas de I'emploi de cette commande avec un APPLE IlGS, le changement 

du mode de visualisation entre le mode APPLE He et le mode APPLE llGS (n=7) 

provoque le passage en graphique de I'ecran. 

Valeurs du parametre n 

Suivant I'unite centrale ou est implantee la carte et suivant la carte couleur mont^e 
dans la machine, certaines configurations seront necessaires pour visualiser 
I'image dans les conditions prevues par le parametre choisi sur un ecran couleur. 
Nous les detaillerons pour chaque parametre. 

C^ 11 = 

Cette vaieur permettra un affichage en mode 'double haute resolution' de 
{'APPLE //e en 16 fausses couleurs, soit une resolution de 192 lignes de 140 
points. 

Configurations pour visualisatton sur ecran couleur : 

APPLE //e et carte EVE : La carte EVE devra etre passee en mode 

couleur par les commandes qui lui sont propres. 
APPLE //e et carte FELINE : Affichage automatique en 16 couleurs. 
APPLE iiGS : la visualisation sera correcte si I'option 'COULEUR' est 

selectionnee dans le menu 'AFFICHAGE' du tableau de bord. 

Fonctionnement : 



Un point sur deux est lu dans la memoire image pour affichage et 40 points sont 
omis en fin de chaque ligne. La couleur de chaque point est codee sur 4 bits. 
L'affichage est limite aux 192 premieres lignes digitalisees. 
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fiW n = l 

Cette valeur permettra une resolution identique a la pr^cedente mais I'affichage 
sera fait en 6 fausses couleurs. Cette resolution permet une meilleure repartition 
des niveaux de gris si I'affichage est fait sur un ecran monochrome. Sur un ecran 
couleur, la perte de definition donne une image plus lissee. 

Configurations pour Yisuallsation sur ecran couleur : 

APPLE lie et carte EVE : La carte EVE devra etre passee en mode 

couleur par les commandes qui lui sont propres. 
APPLE lie et carte FELINE : Affichage automatique en 6 couleurs. 
APPLE IIGS : la visualisation sera correcte si I'option 'COULEUR' est 

selectionnee dans le menu 'AFFICHAGE' du tableau de bord. 

Fonctionnement : 

Un point sur deux est lu dans la memoire image pour affichage^ et 40 points sont 
omis en fin de chaque ligne. La couleur de chaque point est codee sur 4 bits. 
L'affichage est limite aux 192 premieres lignes digitalisees. 



t^ n = 2 

Cette valeur est prevue pour un affichage en mode noir & blanc avec une 
resolution de 192 lignes de 280 points sur 3 niveaux de gris obtenus par 
matrigage. 

Configurations pour -visualisation sur ecran couleur : 

APPLE lie et carte EVE : La carte EVE devra etre passee en mode 

noir & blanc par les commandes qui lui sont propres. 
APPLE lie et carte FELINE : Affichage automatique en noir & blanc. 
APPLE llGS : la visualisation sera correcte si I'option 'MONOCHROME' est 

selectionnee dans le menu 'AFFICHAGE' du tableau de bord. 

Fonctionnement : 

Chaque point est lu dans la memoire image pour affichage et 40 points sont omis 
en fin de chaque ligne. Chaque point est traite selon deux seuils intermediaires 
pour constituer une matrice de 2 points de large. 
L'affichage est limite aux 192 premieres lignes digitalisees. 
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new n = 3 

Cette valeur est prevue pour un affichage en mode noir & blanc avec une 
resolution de 192 lignes de 280 points sur 5 niveaux de gris obtenus par 
matrigage. 

Configurations pour Yisualisation sur icrsm couleur : 

APPLE lie et carte EVE : La carte EVE devra etre passee en mode 

noir & blanc par les commandes qui lui sont propres. 
APPLE lie et carte FELINE : Affichage automatique en noir & blanc. 
APPLE liGS : la visualisation sera correcte si I'option 'MONOCHROME' est 

selectionnee dans le menu 'AFFICHAGE' du tableau de bord. 

Fonctionnement : 

Chaque point est lu dans la memoire image pour affichage et 40 points sont omis 
en fin de chaque ligne. La matrice est definie par un carre de 2 x 2 pixels, ce qui 
implique qu'une ligne sur deux est lue pour constituer cet affichage. 
L'affichage est limite aux 192 premieres lignes digitalisees. 



n = 4 



Cette valeur est prevue pour un affichage en mode noir & blanc avec une 
resolution de 140 points sur 192 lignes en 16 niveaux obtenus par matrigage. 

Configurations pour visualisation sur ecran couleur ; 

APPLE lie et carte EVE : La carte EVE devra etre passee en mode 

noir & blanc par les commandes qui lui sont propres. 
APPLE lie et carte FELINE : Affichage automatique en noir & blanc. 
APPLE liGS : la visualisation sera correcte si I'option 'MONOCHROME' est 

selectionnee dans le menu 'AFFICHAGE' du tableau de bord. 

Fonctionnement : 



Un point sur deux est lu dans la memoire image pour affichage et 40 points sont 
omis en fin de chaque ligne. La matrice est definie par un carre de 4 x 2 pixels, ce 
qui implique qu'une ligne sur deux est lue pour constituer cet affichage. 
L'affichage est limite aux 192 premieres lignes digitalisees. 
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CF- 11=7 

Mors que les cinq premieres valeurs fonctionnent aussi bien sur APPLE He que 
sur APPLE IIGS en mode Emulation APPLE He, cette derniere valeur ne peut etre 
utilisee que sur APPLE llGS en mode emulation. Celui-ci devra etre configure en 
mode afficliage couleur pour cette option. 

Elle permet un afficliage en 16 niveaux d'intensite, par defaut en noir & blanc mais 

pouvant etre modifie par les commandes de palette. 

La resolution, dans ce mode, est alors de 200 lignes de 320 points. 

Si cette valeur est programmee sur un APPLE He, elle sera sans effet. 

Si cette option d'affichage est utilisee, il sera recommande de revenir en mode 
texte par la commande (Ctl-l)T avant de terminer un programme, I'instruction 
BASIC : TEXT ne fonctionnant pas dans ce mode si I'ecran est reste en graphique. 

Remarque : cette option ne fonctionne pas sous PASCAL. 



Note : Les valeurs 5 et 6 du parametre n sont incorrectes et refusees par ie logiciel 
de la carte. 
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(Ctl-l)Vj Affichage a I'ecran 



BASIC : PRINT CHR$(9);"V" 
GBASIC :LPRINTCHR$(137);"V" 
PASCAL : WRTTELN (PTR,CHR(9),'V'); 

Cette commande permet I'affichage de I'image digitalisee a I'ecran dans le mode 
qui a ete defini par la commande (Ctl-I)nM. 11 s'agit uniquement du transfert du 
contenu de la memoire image de la carte. Cette commande ne langant pas de 
digitalisation, il faudra avoir passe au moins une fois la commande (Ctl-I)A pour 
avoir un resultat significatif a I'ecran. 
L'ecran passe automatiquement en mode graphique par cette commande. 

Si un ordre de digitalisation (Ctl-I)A a ete passe et qu'aucune source video en etat 
de fonctionnement n'est connectee a la carte, I'ecran de I'unite centraie est force 
en mode texte s'il etait en mode graphique, et un message d'erreur s'affiche 
signalant I'anomalie. 

Note : I'affichage de I'erreur ne se fait que sous BASIC APPLESOFT et aucun 
autre type de detection d'erreur n'est pr^vu. 

Sous CP/M ou PASCAL, I'ecran repasse uniquement en mode texte s'il etait en 
graphique. De plus, aucun status d'erreur n'est retourne pour ne pas avoir a 
redemarrer un programme sous PASCAL. 
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(Cti-iyrj Ecran en mode texte 

BASIC : PRINT CHR$(9);"T" 
GBASIC :LPRINTCHR$(B7);"T" 
PASCAL : WRITELN (PTR,CHR(9),'T'); 

Cette commande permet de revenir a I'ecran texte lorsque Ton est en graphique, 
sans detaiire I'image affichee. 



(Ctl-I)G^ Ecran en mode graphique 

BASIC : PRINT CHR$(9);"G" 
GBASIC :LPRINTCHR$(B7);"G" 
PASCAL : WRITELN (PTR,CHR(9);G'); 

Cette commande a I'effet inverse de la precedente. On peut ainsi retrouver une 
image precedemment affichee, sans perdre pour cela I'etat de I'ecran texte. 
Sur un APPLE IIGS, on garde !e souvenir du mode d'affichage pour tenir compte 
du type de visualisation. 



(ai-l)X ) Commutation sortie PERITEL 



BASIC : PRINT CHR$(9);"X" 
GBASIC :LPRINTCHR$(B7);"X" 
PASCAL : WRITELN (PTR,CHR(9),'X'); 

Cette commande fonctionne en mode bistable et permet de commander la prise 
PERITEL d'un televiseur domestique pour le passer soit en mode moniteur, soit en 
mode reception TV. L'empioi du boTtier special est ne&essaire pour utiliser 
efficacement cette sortie. 

Rappelons que la commande (Ctl-l)D de remise des parametres a leurs valeurs 
par defaut passe cette sortie en position de commande moniteur. 



Carte DGA-1 



Nautil 



Page 37 



'(Ctl-I)R ) RESET 

BASIC : PRINT CHR$(9);"R" 
GBASIC :Nonsiipportee 
PASCAL : Non sopportfe 

Cette commande, contrairement aux autres, ne supporte pas le chaTnage avec 

d'autres caracteres a sa suite. 

Elle permet de deselectionner la carte sans faire de commande "PR£0". 

Elle ne fonctionne que sous BASIC APPLESOFT. 

Cette commande a I'avantage de detecter la carte 80 colonnes de I'unite centrale 

et de la reconnecter sans que I'utilisateur ait a repasser la commande "PR£3" qui 

effacerait I'ecran. II est done conseille de I'utiliser systematiquement a la place du 

"PR£0". 



(Ctl-I)nP) Changement PALETTE 



BASIC : PRINT CHR$(9);"0P" 
GBASIC :LPRINTCHR$(B7);"1P" 
PASCAL : WRITELN (PTR,CHR(9),'2P'); 

Cette commande n'est operationnelie que sur I'APPLE llGS en mode emulation 

APPLE He. Si elle est passee sur un APPLE lie, elle est ignoree. Elle n'est 

egalement prise en compte que si la derniere image visuaiisee est en resolution 

320x200. 

Le parametre n peut varier de a 6, permettant un affichage monochrome dans 

les 3 couleurs primaires et les 3 couleurs complementaires plus le noir & bianc. 

La valeur par defaut est 0, donnant un affichage en noir & blanc. 

Valeurs du parametre n 

n = : Noir & blanc 

n = 1 : Rouge n = 4 : Cyan 

n = 2 : Vert n = 5 : Jaune 

n = 3 : Bleu n = 6 : Magenta 
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(Ctl-l)S ^ Sauvegarde image ecran 

(ai-i)os 



BASIC : PRINT CHR$(9);"S" 

GBASIC :LPRINTCHR$(137);"S" (Resultat sans garantie) 

PASCAL : WRTTELN (PTR,CHR(9),'S'); (Sous reserve) 

Ces commandes sont des routines permettant de transferer les parties ou totalites 

d'images ECRAN se trouvant dans la memoire auxiliaire de I'APPLE vers la 

memoire principale. Elies ont ete congues avant tout pour le BASIC APPLESOFT 

afin que le programme d'appiication puisse ensuite sauvegarder I'image de la 

memoire ecran sur disquette grace a I'instruction BSAVE. 

Pour utiliser cette commande, il est bien evident qu'il faut travailler sous DOS et 

avoir demarre le systeme avec une disquette. 

L'utilisation du parametre n ou I'absence de ce parametre est identique au 

fonctionnement de la commande de chargement d'image ecran et sera decrite 

dans ce chapitre. 

Si la sauvegarde concerne une image en mode 320x200, les pointeurs de 

palettes et les palettes sont egalement sauvegardes. 

La palette creee dans ce format est la palette 0, celle utilisee couramment dans le 

logiciel GS PAINT. Les images sauvegardees sous PRODOS peuvent etre relues 

par ce logiciel. 




Chargement image ecran 



BASIC : PRINT CHR$(9);"C" 

GBASIC :LPRINTCHR$(137);"C" (Resultat sans garantie) 

PASCAL : WRITELN (Fm,CHR(9),'C'); (Sous reserve) 

Cette commande a la fonction inverse de la precedente, c'est-a-dire qu'elle 
transfere des parties de memoire principale dans la memoire auxiliaire. 

Attention : Ces commandes occupent une place importante en memoire 

principale. 

Si elles sont utilisees, il faudra prendre les precautions decrites precedemment 

concernant les protections de zone memoire en fonction du type de parametrage. 

Sous GBASIC ou PASCAL, les protections memoires devront etre faites par 

I'utilisateur en fonction de son logiciel. 
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Commandes (Ctl-I)S ou (CtI-I)C 

Ces commandes concernent les images de type 'double haute resolution' sur 
APPLE lie ou APPLE IIGS dans ce mode. 

Ces images occupent un espace memoire total de 16 Ko et leur emplacement est 

reparti par moitie dans chaque banc memoire de I'unite centrale. 

A savoir : 8 Ko sont implantes en memoire principale entre les adresses 8192 

($2000) et 16383 ($3FFF) et le meme espace, aux memes adresses, est alloue 

en memoire auxiliaire. 

Ces deux commandes effectuent un transfert entre la zone memoire occup§e par 

I'image en memoire auxiliaire et un espace situe au-dessus de la zone memoire 

image de la memoire principale, soit entre les adresses 16384 ($4000) et 24575 

($5FFF). 

La commande (Ctl-l)S fait le transfert dans le sens memoire auxiliaire vers 

memoire principale, et la commande (Ctl-l)C dans le sens inverse. 

Exemple : Le programme BASIC ci-dessous permet de faire une digitalisation 
suivie d'un affichage ecran, puis de sauvegarder cette image sur disquette. La 
carte est implantee en slot 2. 

10 LOMEM : 24576 : REM Cette instruction en debut de programme 

20 D$ = CHR$(4) : 1$ = CH[R$(9) : REM (Ctl-D) et (Ctl-I) 

30 PRINT D$;"PR£2" : REM Carte en slot 2 

40 PRINT 1$;" A0MV" : REM Digitalise, defini le mode et visualise 

50 PRINT 1$;" S" : REM Transfere I'image sur memoire principale 

60 PRINT I$;"R" : REM Deselectionne la carte 

70 PRINT D$;"BSAVE IMAGE^$2000,L$3FFF" : REM Sauvegarde 

De la meme maniere, le programme ci-dessous est un exemple de I'operation 
inverse. 



10 LOMEM : 24576 : REM Cette instraction en debut de programme 

20 D$ = CHR$(4) : 1$ = CHR$(9) : REM (Ctl-D) et (Ctl-I) 

30 PRINT D$;"BLOAD IMAGE,A$2000" : REM Chargement 

40 PRINT D$;"PR£2" : REM Carte en slot 2 

50 PRINT I$;"CVR" : REM Transfert, visualisation et deselection 
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Commandes (Ctl-I)BS ou (Cfl-I)nC 

Ces commandes concement les images au format APPLE !!GS (320 x 200). 

Le parametre n peut prendre les valeurs - 1 ou 2. 

Ces images occupent un espace de 32 Ko entierement situe en memoire 

auxiliaire. Pour pouvoir les sauvegarder comme decrit precedemment, ii faut les 

transferer en totalite dans la memoire principale. 

Les trois valeurs de parametre definissent 2 cas de transfert possibles. 

n = 

Dans ce cas, I'image est transferee en totalite. Elle s'implante a I'adresse 4096 
($1000) et se termine a I'adresse 36863 ($8FFF). 
L'instruction BASIC pour la sauvegarder sur disquette sera : 

BSAVE "IMAGE , A$1000 , L$ 7FFF" 

Note : c'est ce format de sauvegarde qui permet un chargement sous le logicie! 

GSPAINT. 

Comme cette implantation reduit considerablement la taille d'un programme 

BASIC de gestion, il a ete prevu une option permettant de sauvegarder I'image en 

deux operations successives. 

11 = 1 

Transfere la premiere moitie de I'image aux memes adresses qu'une image en 
mode 'double haute resolution', soit entre 8192 ($2000) et 24575 ($5FFF). 

11 = 2 

Transfere la seconde moitie de I'image aux memes adresses. 

La sauvegarde sur disquette se fera aiors par deux transferts et deux sauvegardes 

successifs comme iliustre par I'exemple ci-dessous. 

10 LOMEM : 24576 : REM Cette instraction en debut de progranmie 

20 D$ = CHR$(4) : 1$ = CHR$(9) : REM (Ctl-D) et (Ctl-I) 

30 PRINT D$;"PR£2" : REM Carte en slot 2 

40 PRINT 1$;" A0MV1SR" : REM Digitalise, visualise et transfere 

70 PRINT D$;"BSAVE IMAGE1A$2000,L$3FFF" : REM Sauve 

30 PRINT D$;"PRf 2" : REM Reselectionne la carte 

40 PRINT I$;"2SR" : REM Transfere la seconde moitie 

70 PRINT D$;"BSAVE IMAGE2^$2000,L$3FFF" : REM Sauve 



Le chargement d'une image reprendra les operations dans I'ordre inverse. 
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(Ctl-l)nL) Sauvegarde memoire image 

BASIC : PRINT CHR$(9);"0L" 

GBASIC : LPRMT CHR$(137);"1L" (Resultat sans garantie) 

PASCAL : WRITELN (PTR,CHR(9),'2L'); (Resultat sans garantie) 

Cette commande permet de faire une lecture de la memoire image de la carte et 
de transferer son contenu en memoire principale afin d'en faire une sauveqarde 
sur disquette. 

La taille de cette memoire etant de 32 ko, les options seront similaires a celles de 
la sauvegarde d'une image au format APPLE IlGS et le parametre n, qui peut 
prendre les memes valeurs (0 a 2), implique le meme processus de sauvegarde. 



_(Ctl-l)nEj Chargement memoire image 



BASIC 

GBASIC 

PASCAL 



PRINT CHR$(9);"0E" 

LPRINT CHR$(137);"1E" (Resultat sans garantie) 

WRITELN (PTR,CHR(9),'2E'); (Resultat sans garantie) 



Cette commande permet I'operation inverse de la precedente, a savoir relire un 
fichier disque au format d'une image source et le recharger dans la memoire 
image de la carte. 

Le programme ci-dessous iliustre cette operation pour une image deia 
sauvegardee sous le nom de 'SOURCE' sur une carte implantee en slot 2. 



10 
20 
30 
40 
50 



LOMEM : 36864 ; REM Cette instraction en debut de programme 

D$ = CHR$(4) : 1$ = CHR$(9) : REM (Ctl-D) et (Ql-I) 

PRINT D$;"BLOAD SOURCE,A$i000" : REM Chargement 

PRINT D$;"PR£2" : REM Carte en slot 2 

PRINT I$;"0E0MVR" : REM Transfert, visuaHsation et deselection 
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K^ 



UTILISATION SUR APPLE IIGS 



Des programmes sont prevus pour fonctionner sur cette machine en mode natif. 

Se reporter au chapitre decrivant le contenu des disquettes fournies avec la carte 

pour leur description. 

Au niveau de la memoire programme de la carte, il est prevu un point d'entree 

special pour les personnes desirant developper leurs propres programmes 

d'application. 

L'acces a ce point d'entree lance d'une part une digitalisation, et effectue ensuite 

le transfer! de la memoire image dans une zone memoire creee par I'application. 

On accede a la carte par la fonction suivante : 

FUNCTION Transfert (Enregistrettent : Ptr) : INTEGER; 

L'application devra tout d'abord creer une zone memoire de 32768 octets 

($8000) par la fonction _NewHandle. 

Les elements de la fonction seront passes par la pile, soit tout d'abord, deux octets 

pour le retour d'erreur, puis le pointeurde la zone memoire creee. 

II suffit ensuite de faire un JSL a I'adresse 00/Cn11 , n etant le slot de la carte. 

Au retour, il faudra depiler deux octets pour recuperer le resultat de la fonction. 

Celui-ci est soit a s'il n'y a pas d'erreur, soit different de (valeur indeterminee) 

si la digitalisation n'a pas eu lieu (source video non active). 

Detenuinatioii du slot de la carte 

Pour qu'une application puisse determiner le slot oij est implantee la carte, il a ete 
prevu dans la memoire programme de celle-ci un signe distinctif. 
Les quatre derniers octets de la zone $Cn00 contiennent les caracteres ASCII 
DGAl (adresses $CnFC a $CnFF). II suffira done de tester successivement le 
contenu de ces adresses dans tous les slots (a partir du slot 1) pour trouver 
■'emplacement de la carte. 

Note : les codes ASCII du mot DGA1 sont respectivement : 



$C4 
$C7 
$C1 
$B1 



Carte DGA-1 



Nautil 



Page 43 



POINTS D'ENTREES DE LA CA:RTE 

Pour les developpeurs desirant faire leurs programmes de gestion de la carte en 
assembleur, nous donnons ci-apres les differents points d'entree de la carte. 



BASIC 

$Cn00 : 
$Cn05 : 

$Cn07: 



Initialisation 

Lecture en entr^ 

Ce point d'entree ne doit pas etre utilise. 

Envoi des commandes 

Le caractere doit etre passe dans I'accumulateur. 

En retour, les registres A, X et Y sont preserves. 

PASCAL L0 - CP/M2.20 

$C800 : initialisation 
$C84D : Lecture en entree 

Renvoie toujours une erreur. 
$C9AA : Envoi des commandes 

Le caractere doit etre dans I'accumulateur. 

Le registre X doit contenir le slot sous la forme $Cn. 

Le registre Y doit contenir le slot x 1 6 sous la forme $n0. 

PASCALU,OetlJ - CP/M 2.23 et 2.26 

Dans ces versions, les points d'entrees se situent dans la zone $Cn00 a $CnFF 
La valeur basse de I'adresse reelle du point d'entree est donnee dans les 
adresses decrites ci-dessous. 

II faudra done lire le contenu de cette adresse qui renverra une valeur $VV le 
point d'entree reel sera alors $CnVV. 

$Cn0D : Initialisation 
$Cn0E : Lecture en entree. 

Ne pas employer ce point d'entree. 
$Cn0F : Envoi des commandes 

Le caractere doit etre dans I'accumulateur. 

Le registre X doit contenir le slot sous la forme $Cn. 

Le registre Y doit contenir le slot x 1 6 sous la forme $n0 
$Cn10: Contrdie d'itat 

La carte ne renvoie une erreur que sur une demande de lecture. 

APPLE IIGS 



$Cn11 : Transfert d'image (Voir description page 40) 
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BISQUETTES DE DEMONSTRATION 

Deux disquettes sont fournies avec la carte DGA-1 . 

Disquette 5 pouces 1/4 pour APPLE //e 
Cette disquette est utilisee sur see deux faces. 

K^ Face DOS 33 

La premiere face, ecrite au format DOS 3.3, regroupe une serie de programmes de 
demonstration, documentes ci-dessous, pouvant fonctionner sous DOS 3.3, 
PRODOS ou CP/M. 

DIGIT.DOS 

Programme de demonstration BASIC regroupant la majorite des fonctions de 
commandes de la carte. Ce programme permet de tester facilement le bon 
fonctionnement de la carte et des connexions. Son listing donnera un bon 
exemple d'utilisation des commandes. 

SLOTJX)S 

Fichier texte qui contient un petit programme de recherche de slot pour la carte 
DGA-1. 11 a et§ ecrit a partir de la ligne 30000 pour pouvoir etre facilement 
incorpore k vos programmes grace a la fonction EXEC. 

Ces deux fichiers fonctionnent aussi bien sous DOS que sous PRODOS. lis 
pourront etre convertis sous PRODOS en les tranferant par les programmes de 
conversion sur une disquette formatee sous ce systeme. 

DIGir.CPM 

Ce programme de demonstration illustre les principales commandes de la carte 
utilisables sous GBASIC. 

II est fourni sous forme de fichier texte APPLESOFT et devra etre converti sous 
CP/M par I'utilitaire APDOS (Voir la documentation CP/M). 
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B.CONV 

II s'agit d'un utilltaire ecrit en langage machine qui fonctionne uniquement sous 
PRODOS. 11 sera done absolument necessaire de le convertir sur une disquette a 
ce format pour I'utiliser. 

Cet utilltaire permet de transformer des fichiers d'images crees par GSPAINT au 
format binaire pouvant etre recharges sous BASIC par I'instruction BLOAD afin de 
pouvoir les visualiser par le programme de demonstration. 

Chargement de cet utllitaire 

II suffit de le lancer par I'instruction : BRUM B.CONV. 

Cette commande charge le programme en $8000, cherche la place disponible en 

haut de memoire et le reloge. 

Si un probleme survient au moment de I'lnstaliation, on aura une erreur (n° 12) 

affichant le message : NO BUFFER AVAILABLE. 

Fonctionnement 

En mode direct : Taper la commande : 

CONVnom.du.fichier 

En mode programme : Par la commande BASIC : 

PRINT CHR$(4);"C0NV nom.du.fichler" 

Le fichier devant etre un fichier image avec comme type $C1 (visible lorsque Ton 
fait le catalogue de la disquette). 

Si la conversion s'est pass6e correctement, le type devient alors BIN comme on 
pourra le verifier en faisant un catalogue. 

Erreiirs possibles 

Certaines erreurs BASIC peuvent etre generees en cas de problemes : 

- SYNTAX ERROR (N°16) : La commande n'a pas ete ecrite correctement ou le 
nom a ete omis. 

- PATH NOT FOUND (N°6) : Le fichier n'a pas ete trouve. Son nom a mal ete rentre 
ou le sous-repertoire est mal indique. 

- FILE TYPE MISMATCH (N°13) : Le fichier n'est pas du type $01. 
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D:^ Face pascal 

La seconde face, ecrite au format PASCAL 1 .3, comporte un petit programme de 
demonstration qui demarre automatiquement. 
II est foumi sous le nom de SYSTEM.STARTUP. 

Le programme source, fourni sous le nom de DEMODGAl.TEXT, pourra servir 
de base de depart d'une application. 



Disqiiette 3 ponces 1/2 pour APPLE IIGS 

Cette disquette contient un programme permettant la digitalisation, la sauvegarde, 
et la restitution d'images au format GSPAINT en mode APPLE llGS natif. 
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LIMTTES DE GAMANTTE 



Les produits NAUTIL sont garantis centre tout defaut de matidre et de fabrication 
pendant une periode d'1 an a compter de la date d'achat. La facture d'achat 
faisant foi et servant de certificat. 

Cette garantie ne couvre pas les materiels accidentellement endommages, mal 
utilises ou ayant fait I'objet d'une reparation ou d'une modification effectuee par 
une personne autre qu'un technicien agree NAUTIL. 

Les logiciels pouvant accompagner les cartes sont concedes "tels quels", sans 
garantie aucune, aux risques et perils de I'acquereur, qui prend en totality a sa 
charge les risques relatifs a la qualite des logiciels et aux resultats obtenus avec 
ces derniers. Dans I'eventualite oCi ces logiciels se rev^leraient defectueux, 
I'acquereur seul prendrait a sa charge les frais de depannage, de correction ou de 
toute autre intervention. 



Les logiciels, les manuels et les materiels NAUTIL sont proteges par des droits de 
propriete intellectuelle et ne peuvent etre copies ou reproduits sous toute forme 
exploitable en tout ou partie sans accord prealable ecrit . 

Les caracteristiques et fonctionnalites des produits NAUTIL (logiciel et materiel) 
decrits dans le present manuel peuvent etre assujeties a des modifications ou a 
des ameliorations a tout moment et sans preavis. 



Notes 



